// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
 
using System;
using Roslyn.Utilities;
 
namespace Microsoft.CodeAnalysis.Editor.UnitTests
{
    internal sealed class TestFixtureHelper<TFixture>
        where TFixture : class, IDisposable, new()
    {
        private readonly object _gate = new();
 
        /// <summary>
        /// Holds a weak reference to the current test fixture instance. This reference allows
        /// <see cref="GetOrCreateFixture"/> to access and add a reference to the current test fixture if one exists,
        /// but does not prevent the fixture from being disposed after the last reference to it is released.
        /// </summary>
        private ReferenceCountedDisposable<TFixture>.WeakReference _weakFixture;
 
        /// <summary>
        /// Gets a reference to a test fixture, or creates it if one does not already exist.
        /// </summary>
        /// <remarks>
        /// <para>The resulting test fixture will not be disposed until the last referencer disposes of its reference.
        /// It is possible for more than one test fixture to be created during the life of any single test, but only one
        /// test fixture will be live at any given point.</para>
        ///
        /// <para>The following shows how a block of test code can ensure a single test fixture is created and used
        /// within any given block of code:</para>
        ///
        /// <code>
        /// using (var fixture = GetOrCreateFixture())
        /// {
        ///   // The test fixture 'fixture' is guaranteed to not be released or replaced within this block
        /// }
        /// </code>
        /// </remarks>
        /// <returns>The test fixture instance.</returns>
        internal ReferenceCountedDisposable<TFixture> GetOrCreateFixture()
        {
            lock (_gate)
            {
                if (_weakFixture.TryAddReference() is { } fixture)
                    return fixture;
 
                var result = new ReferenceCountedDisposable<TFixture>(new TFixture());
                _weakFixture = new ReferenceCountedDisposable<TFixture>.WeakReference(result);
                return result;
            }
        }
    }
}